<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkImageMenuItem: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkActivatable.html" title="GtkActivatable">
<link rel="next" href="GtkMisc.html" title="GtkMisc">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GtkImageMenuItem.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GtkImageMenuItem.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GtkImageMenuItem.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GtkImageMenuItem.properties" class="shortcut">Properties</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkActivatable.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkMisc.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkImageMenuItem"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkImageMenuItem.top_of_page"></a>GtkImageMenuItem</span></h2>
<p>GtkImageMenuItem — A deprecated widget for a menu item with an icon</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkImageMenuItem.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-image" title="gtk_image_menu_item_set_image ()">gtk_image_menu_item_set_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-get-image" title="gtk_image_menu_item_get_image ()">gtk_image_menu_item_get_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-new" title="gtk_image_menu_item_new ()">gtk_image_menu_item_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-new-from-stock" title="gtk_image_menu_item_new_from_stock ()">gtk_image_menu_item_new_from_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-new-with-label" title="gtk_image_menu_item_new_with_label ()">gtk_image_menu_item_new_with_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-new-with-mnemonic" title="gtk_image_menu_item_new_with_mnemonic ()">gtk_image_menu_item_new_with_mnemonic</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-get-use-stock" title="gtk_image_menu_item_get_use_stock ()">gtk_image_menu_item_get_use_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-use-stock" title="gtk_image_menu_item_set_use_stock ()">gtk_image_menu_item_set_use_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-get-always-show-image" title="gtk_image_menu_item_get_always_show_image ()">gtk_image_menu_item_get_always_show_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-always-show-image" title="gtk_image_menu_item_set_always_show_image ()">gtk_image_menu_item_set_always_show_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-accel-group" title="gtk_image_menu_item_set_accel_group ()">gtk_image_menu_item_set_accel_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *</td>
<td class="property_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItem--accel-group" title="The “accel-group” property">accel-group</a></td>
<td class="property_flags">Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItem--always-show-image" title="The “always-show-image” property">always-show-image</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</td>
<td class="property_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItem--image" title="The “image” property">image</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItem--use-stock" title="The “use-stock” property">use-stock</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItem-struct" title="struct GtkImageMenuItem">GtkImageMenuItem</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkImageMenuItem.html#GtkImageMenuItemClass" title="struct GtkImageMenuItemClass">GtkImageMenuItemClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GInitiallyUnowned
        <span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
            <span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                <span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
                    <span class="lineart">╰──</span> <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>
                        <span class="lineart">╰──</span> GtkImageMenuItem
</pre>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkImageMenuItem implements
 AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> and  <a class="link" href="GtkActionable.html" title="GtkActionable">GtkActionable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.description"></a><h2>Description</h2>
<p>A GtkImageMenuItem is a menu item which has an icon next to the text label.</p>
<p>This is functionally equivalent to:</p>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">box</span> <span class="o">=</span> <span class="n">gtk_box_new</span> <span class="p">(</span><span class="n">GTK_ORIENTATION_HORIZONTAL</span><span class="p">,</span> <span class="mi">6</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">icon</span> <span class="o">=</span> <span class="n">gtk_image_new_from_icon_name</span> <span class="p">(</span><span class="s">&quot;folder-music-symbolic&quot;</span><span class="p">,</span> <span class="n">GTK_ICON_SIZE_MENU</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">label</span> <span class="o">=</span> <span class="n">gtk_label_new</span> <span class="p">(</span><span class="s">&quot;Music&quot;</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">menu_item</span> <span class="o">=</span> <span class="n">gtk_menu_item_new</span> <span class="p">();</span>

<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">box</span><span class="p">),</span> <span class="n">icon</span><span class="p">);</span>
<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">box</span><span class="p">),</span> <span class="n">label</span><span class="p">);</span>

<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">menu_item</span><span class="p">),</span> <span class="n">box</span><span class="p">);</span>

<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">menu_item</span><span class="p">);</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
<p>Note that the user may disable display of menu icons using
the <a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a> setting, so make sure to still
fill in the text label. If you want to ensure that your menu items
show an icon you are strongly encouraged to use a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
with a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> instead.</p>
<p><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> has been deprecated since GTK+ 3.10. If you want to
display an icon in a menu item, you should use <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> and pack a
<a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> with a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> and a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> instead. You should also consider
using <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> and the XML <span class="type">GMenu</span> description for creating menus, by
following the GMenu guide. You should
consider using icons in menu items only sparingly, and for "objects" (or
"nouns") elements only, like bookmarks, files, and links; "actions" (or
"verbs") should not have icons.</p>
<p>Furthermore, if you would like to display keyboard accelerator, you must
pack the accel label into the box using <a class="link" href="GtkBox.html#gtk-box-pack-end" title="gtk_box_pack_end ()"><code class="function">gtk_box_pack_end()</code></a> and align the
label, otherwise the accelerator will not display correctly. The following
code snippet adds a keyboard accelerator to the menu item, with a key
binding of Ctrl+M:</p>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">box</span> <span class="o">=</span> <span class="n">gtk_box_new</span> <span class="p">(</span><span class="n">GTK_ORIENTATION_HORIZONTAL</span><span class="p">,</span> <span class="mi">6</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">icon</span> <span class="o">=</span> <span class="n">gtk_image_new_from_icon_name</span> <span class="p">(</span><span class="s">&quot;folder-music-symbolic&quot;</span><span class="p">,</span> <span class="n">GTK_ICON_SIZE_MENU</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">label</span> <span class="o">=</span> <span class="n">gtk_accel_label_new</span> <span class="p">(</span><span class="s">&quot;Music&quot;</span><span class="p">);</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">menu_item</span> <span class="o">=</span> <span class="n">gtk_menu_item_new</span> <span class="p">();</span>
<span class="n">GtkAccelGroup</span> <span class="o">*</span><span class="n">accel_group</span> <span class="o">=</span> <span class="n">gtk_accel_group_new</span> <span class="p">();</span>

<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">box</span><span class="p">),</span> <span class="n">icon</span><span class="p">);</span>

<span class="n">gtk_label_set_use_underline</span> <span class="p">(</span><span class="n">GTK_LABEL</span> <span class="p">(</span><span class="n">label</span><span class="p">),</span> <span class="n">TRUE</span><span class="p">);</span>
<span class="n">gtk_label_set_xalign</span> <span class="p">(</span><span class="n">GTK_LABEL</span> <span class="p">(</span><span class="n">label</span><span class="p">),</span> <span class="mf">0.0</span><span class="p">);</span>

<span class="n">gtk_widget_add_accelerator</span> <span class="p">(</span><span class="n">menu_item</span><span class="p">,</span> <span class="s">&quot;activate&quot;</span><span class="p">,</span> <span class="n">accel_group</span><span class="p">,</span>
                            <span class="n">GDK_KEY_m</span><span class="p">,</span> <span class="n">GDK_CONTROL_MASK</span><span class="p">,</span> <span class="n">GTK_ACCEL_VISIBLE</span><span class="p">);</span>
<span class="n">gtk_accel_label_set_accel_widget</span> <span class="p">(</span><span class="n">GTK_ACCEL_LABEL</span> <span class="p">(</span><span class="n">label</span><span class="p">),</span> <span class="n">menu_item</span><span class="p">);</span>

<span class="n">gtk_box_pack_end</span> <span class="p">(</span><span class="n">GTK_BOX</span> <span class="p">(</span><span class="n">box</span><span class="p">),</span> <span class="n">label</span><span class="p">,</span> <span class="n">TRUE</span><span class="p">,</span> <span class="n">TRUE</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>

<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">menu_item</span><span class="p">),</span> <span class="n">box</span><span class="p">);</span>

<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">menu_item</span><span class="p">);</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-image-menu-item-set-image"></a><h3>gtk_image_menu_item_set_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_menu_item_set_image (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *image</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_set_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Sets the image of <em class="parameter"><code>image_menu_item</code></em>
 to the given widget.
Note that it depends on the show-menu-images setting whether
the image will be displayed or not.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-set-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>image</p></td>
<td class="parameter_description"><p>a widget to set as the image for the menu item. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-get-image"></a><h3>gtk_image_menu_item_get_image ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_menu_item_get_image (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_get_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Gets the widget that is currently set as the image of <em class="parameter"><code>image_menu_item</code></em>
.
See <a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-image" title="gtk_image_menu_item_set_image ()"><code class="function">gtk_image_menu_item_set_image()</code></a>.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-get-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-get-image.returns"></a><h4>Returns</h4>
<p>the widget set as image of <em class="parameter"><code>image_menu_item</code></em>
. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-new"></a><h3>gtk_image_menu_item_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_menu_item_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_menu_item_new</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkMenuItem.html#gtk-menu-item-new" title="gtk_menu_item_new ()"><code class="function">gtk_menu_item_new()</code></a> instead.</p>
</div>
<p>Creates a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> with an empty label.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-new-from-stock"></a><h3>gtk_image_menu_item_new_from_stock ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_menu_item_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
                                    <em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_menu_item_new_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-mnemonic" title="gtk_menu_item_new_with_mnemonic ()"><code class="function">gtk_menu_item_new_with_mnemonic()</code></a> instead.</p>
</div>
<p>Creates a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> containing the image and text from a
stock item. Some stock ids have preprocessor macros like <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><span class="type">GTK_STOCK_OK</span></a>
and <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-APPLY:CAPS" title="GTK_STOCK_APPLY"><span class="type">GTK_STOCK_APPLY</span></a>.</p>
<p>If you want this menu item to have changeable accelerators, then pass in
<code class="literal">NULL</code> for accel_group. Next call <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-accel-path" title="gtk_menu_item_set_accel_path ()"><code class="function">gtk_menu_item_set_accel_path()</code></a> with an
appropriate path for the menu item, use <a class="link" href="gtk3-Stock-Items.html#gtk-stock-lookup" title="gtk_stock_lookup ()"><code class="function">gtk_stock_lookup()</code></a> to look up the
standard accelerator for the stock item, and if one is found, call
<a class="link" href="gtk3-Accelerator-Maps.html#gtk-accel-map-add-entry" title="gtk_accel_map_add_entry ()"><code class="function">gtk_accel_map_add_entry()</code></a> to register it.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-new-from-stock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p>the name of the stock item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>accel_group</p></td>
<td class="parameter_description"><p>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to add the menu items
accelerator to, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-new-from-stock.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-new-with-label"></a><h3>gtk_image_menu_item_new_with_label ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_menu_item_new_with_label (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_menu_item_new_with_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-label" title="gtk_menu_item_new_with_label ()"><code class="function">gtk_menu_item_new_with_label()</code></a> instead.</p>
</div>
<p>Creates a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> containing a label.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-new-with-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>the text of the menu item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-new-with-label.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-new-with-mnemonic"></a><h3>gtk_image_menu_item_new_with_mnemonic ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_menu_item_new_with_mnemonic (<em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_menu_item_new_with_mnemonic</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkMenuItem.html#gtk-menu-item-new-with-mnemonic" title="gtk_menu_item_new_with_mnemonic ()"><code class="function">gtk_menu_item_new_with_mnemonic()</code></a> instead.</p>
</div>
<p>Creates a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> containing a label. The label
will be created using <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()"><code class="function">gtk_label_new_with_mnemonic()</code></a>, so underscores
in <em class="parameter"><code>label</code></em>
 indicate the mnemonic for the menu item.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-new-with-mnemonic.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>the text of the menu item, with an underscore in front of the
mnemonic character</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-new-with-mnemonic.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-get-use-stock"></a><h3>gtk_image_menu_item_get_use_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_image_menu_item_get_use_stock (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_get_use_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Checks whether the label set in the menuitem is used as a
stock id to select the stock item for the item.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-get-use-stock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-get-use-stock.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the label set in the menuitem is used as a
stock id to select the stock item for the item</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-set-use-stock"></a><h3>gtk_image_menu_item_set_use_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_menu_item_set_use_stock (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>,
                                   <em class="parameter"><code><span class="type">gboolean</span> use_stock</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_set_use_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>If <code class="literal">TRUE</code>, the label set in the menuitem is used as a
stock id to select the stock item for the item.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-set-use-stock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>use_stock</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the menuitem should use a stock item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-get-always-show-image"></a><h3>gtk_image_menu_item_get_always_show_image ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_image_menu_item_get_always_show_image
                               (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_get_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Returns whether the menu item will ignore the <a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a>
setting and always show the image, if available.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-get-always-show-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-image-menu-item-get-always-show-image.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the menu item will always show the image</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-set-always-show-image"></a><h3>gtk_image_menu_item_set_always_show_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_menu_item_set_always_show_image
                               (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>,
                                <em class="parameter"><code><span class="type">gboolean</span> always_show</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_set_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>If <code class="literal">TRUE</code>, the menu item will ignore the <a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a>
setting and always show the image, if available.</p>
<p>Use this property if the menuitem would be useless or hard to use
without the image.</p>
<div class="refsect3">
<a name="gtk-image-menu-item-set-always-show-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>always_show</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the menuitem should always show the image</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-image-menu-item-set-accel-group"></a><h3>gtk_image_menu_item_set_accel_group ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_menu_item_set_accel_group (<em class="parameter"><code><a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a> *image_menu_item</code></em>,
                                     <em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_image_menu_item_set_accel_group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Specifies an <em class="parameter"><code>accel_group</code></em>
 to add the menu items accelerator to
(this only applies to stock items so a stock item must already
be set, make sure to call <a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-set-use-stock" title="gtk_image_menu_item_set_use_stock ()"><code class="function">gtk_image_menu_item_set_use_stock()</code></a>
and <a class="link" href="GtkMenuItem.html#gtk-menu-item-set-label" title="gtk_menu_item_set_label ()"><code class="function">gtk_menu_item_set_label()</code></a> with a valid stock item first).</p>
<p>If you want this menu item to have changeable accelerators then
you shouldnt need this (see <a class="link" href="GtkImageMenuItem.html#gtk-image-menu-item-new-from-stock" title="gtk_image_menu_item_new_from_stock ()"><code class="function">gtk_image_menu_item_new_from_stock()</code></a>).</p>
<div class="refsect3">
<a name="gtk-image-menu-item-set-accel-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>image_menu_item</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem"><span class="type">GtkImageMenuItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>accel_group</p></td>
<td class="parameter_description"><p>the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkImageMenuItem-struct"></a><h3>struct GtkImageMenuItem</h3>
<pre class="programlisting">struct GtkImageMenuItem;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkImageMenuItemClass"></a><h3>struct GtkImageMenuItemClass</h3>
<pre class="programlisting">struct GtkImageMenuItemClass {
  GtkMenuItemClass parent_class;
};
</pre>
<div class="refsect3">
<a name="GtkImageMenuItemClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody></tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkImageMenuItem.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkImageMenuItem--accel-group"></a><h3>The <code class="literal">“accel-group”</code> property</h3>
<pre class="programlisting">  “accel-group”              <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *</pre>
<p>The Accel Group to use for stock accelerator keys</p>
<div class="warning">
<p><code class="literal">GtkImageMenuItem:accel-group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-add-accelerator" title="gtk_widget_add_accelerator ()"><code class="function">gtk_widget_add_accelerator()</code></a> instead</p>
</div>
<p>Owner: GtkImageMenuItem</p>
<p>Flags: Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkImageMenuItem--always-show-image"></a><h3>The <code class="literal">“always-show-image”</code> property</h3>
<pre class="programlisting">  “always-show-image”        <span class="type">gboolean</span></pre>
<p>If <code class="literal">TRUE</code>, the menu item will always show the image, if available.</p>
<p>Use this property only if the menuitem would be useless or hard to use
without the image.</p>
<div class="warning">
<p><code class="literal">GtkImageMenuItem:always-show-image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> containing a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> with
  a <a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel"><span class="type">GtkAccelLabel</span></a> and a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> instead</p>
</div>
<p>Owner: GtkImageMenuItem</p>
<p>Flags: Read / Write / Construct</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkImageMenuItem--image"></a><h3>The <code class="literal">“image”</code> property</h3>
<pre class="programlisting">  “image”                    <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</pre>
<p>Child widget to appear next to the menu text.</p>
<div class="warning">
<p><code class="literal">GtkImageMenuItem:image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> containing a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> with
  a <a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel"><span class="type">GtkAccelLabel</span></a> and a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> instead</p>
</div>
<p>Owner: GtkImageMenuItem</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkImageMenuItem--use-stock"></a><h3>The <code class="literal">“use-stock”</code> property</h3>
<pre class="programlisting">  “use-stock”                <span class="type">gboolean</span></pre>
<p>If <code class="literal">TRUE</code>, the label set in the menuitem is used as a
stock id to select the stock item for the item.</p>
<div class="warning">
<p><code class="literal">GtkImageMenuItem:use-stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use a named icon from the <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> instead</p>
</div>
<p>Owner: GtkImageMenuItem</p>
<p>Flags: Read / Write / Construct</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.16</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>